IBM Books

Network Utility User's Guide


Chapter 7. Handling Configuration Files

This chapter describes specific procedures for:

For background information about configuring Network Utility, see Chapter 3, "Performing the Initial Configuration" and Chapter 6, "Configuration Concepts and Methods".

For details about the individual commands introduced in this chapter, see the following chapters in the MAS Software User's Guide:


Managing Configuration Files on Disk

All the commands to list and manage configuration files on the Network Utility hard disk are located in the boot Config subprocess. The following example shows how to reach this subprocess and list the available commands:

  *t 6
                <Enter>
  Config>boot
  Boot configuration
  Boot config>?
  ADD description
  COPY software
  DESCRIBE software VPD
  DISABLE boot choices
  ENABLE boot choices
  ERASE software
  LIST software status
  LOCK Config File
  SET boot information
  TFTP software
  TIMEDLOAD software
  UNLOCK Config File
  UPDATE Firmware
  EXIT
  Boot config>

Listing Configurations

The list command is the starting point for viewing what configuration files are present in the four positions of each of the two code load banks. This same display is integrated into a number of the commands on the menu.

  Boot config>li
  +------ BankA -----------+--------- Description ----------+------ Date -------+
  | IMAGE - ACTIVE         |                                | 03 Aug 1998 10:04 |
  | CONFIG 1 - AVAIL       |                                | 04 Aug 1998 13:50 |
  | CONFIG 2 - ACTIVE  *   | example config 1               | 04 Aug 1998 13:52 |
  | CONFIG 3 - AVAIL       |                                | 04 Aug 1998 06:41 |
  | CONFIG 4 - AVAIL       |                                | 04 Aug 1998 09:43 |
  +------ BankB -----------+--------- Description ----------+------ Date -------+
  | IMAGE - PENDING        |                                | 05 Aug 1998 03:41 |
  | CONFIG 1 - PENDING *   |                                | 31 Jul 1998 12:59 |
  | CONFIG 2 - AVAIL       |                                | 31 Jul 1998 09:50 |
  | CONFIG 3 - AVAIL       |                                | 31 Jul 1998 09:52 |
  | CONFIG 4 - AVAIL       |                                | 31 Jul 1998 12:50 |
  +------------------------+--------------------------------+-------------------+
    * - Last Used Config      L - Config File is Locked
 
   Auto-boot mode is enabled.   Fast-boot mode is enabled.
 
  Time Activated Load Schedule Information...
 
  The load timer is not currently activated.
  Boot config>

Image (code load) and configuration states are defined as follows:

ACTIVE
The file was used for the current boot of the Network Utility
AVAIL
This is a valid file that can be made ACTIVE.
CORRUPT
The file is not usable. Normally, this is because a file transfer to this position did not complete successfully.
LOCAL
The file will be used only on the next load or reset. After the file is used, it will be placed in the AVAIL state.
NONE
No file is present in the position (the initial state).
PENDING
The file will be used on the next reload, reset, or power-on of the Network Utility.

To remind yourself of what is in a particular configuration file, use the add command to enter a brief description.

Making a Configuration Active

To make a particular configuration file active, you make it the PENDING configuration file in the bank with the ACTIVE or PENDING code load, and then reboot Network Utility. You do this either when the file already exists or when you create it, as follows:

Delayed Activation

There are two ways to cause a timed, presumably unattended, activation of a configuration:

File Utilities

The boot Config subprocess provides a number of utility commands for managing configuration files (and code loads) on disk:

add
to enter a short description of a configuration

copy
to copy a configuration between banks and/or file positions

erase
to remove a configuration file and return the position status to NONE

lock
to prevent the file from being overwritten by one of the file creation methods

unlock
to allow a file position to be used again for a new file

Firmware Change Management

Most of the configuration management functions in the boot Config subprocess are also available from Network Utility firmware menus. To access them, select the following sequence starting from the firmware main menu:


Loading New Configuration Files

Table 7-1 summarizes the ways you can transfer a configuration from outside the Network Utility to its hard disk. SNMP involves a direct transfer from the Configuration Program to the Network Utility, while TFTP and Xmodem require the configuration file to be on a workstation that acts as a file server to the Network Utility.

Which method you choose to transfer it into the Network Utility depends on how you can attach to the Network Utility, whether you are using the Configuration Program, what software you have on your workstation, and your own preferences. Network Utility configuration files are typically small enough that transfer times over low-speed modems are reasonable.

Table 7-1. Loading Configurations

 
Physical Attachment
Line
Protocol
Transfer
Protocol
 
Tool
 
Default IP Addresses
Service port + null modem
Service port + ext modem
PCMCIA modem
Async
terminal
 
Xmodem
 
Firmware
 
Not applicable
SLIP TFTP Op-code Network Utility=10.1.1.2
Workstation=10.1.1.3
SNMP Cfg pgm
PCMCIA EtherJet
Ethernet LIC (10 Mbps)
Token-Ring LIC
IP  
TFTP
Op-code
Firmware
Network Utility=10.1.0.2
Workstation=10.1.0.3
SNMP Cfg pgm
Any IP network interface IP TFTP Op-code No defaults
SNMP Cfg pgm

The following sections summarize each of the possible configuration transfer procedures, grouping them by the tool from which you start the transfer.

Using the Configuration Program

There are two ways to transfer a configuration from the Configuration Program to a Network Utility.

  1. Create a router configuration file and then use the Network Utility operational code or firmware as the tool from which to do the transfer.

  2. Use SNMP to transfer the configuration to Network Utility memory and hard disk.

Exporting a Router Configuration File

After you have started the Configuration Program and created a Network Utility configuration, move to the Navigation Window and:

  1. Bring up the Configure drop-down menu and select Create router configuration.

  2. Choose the directory path and filename on the workstation where you are running the Configuration Program, where you want the router configuration file (.cfg) to be stored.

  3. Click on OK. The Configuration Program writes this file to disk.

  4. Select Save as under Configure so that you also save the configuration in .csf format, the preferred format for archiving.

It is then your responsibility to load the file onto your Network Utility, using either the operational code or firmware to do the loading. You can follow any of the procedures described in Using the Operational Code or Using the Firmware.

If your Configuration Program PC or workstation cannot be the TFTP or Xmodem server for the file transfer in these procedures, you must first move the .cfg file to a workstation that can be the server. You can use any file transfer method, such as FTP, to move the file between the workstations.

Directly Sending Using SNMP

In order to use SNMP transfer, you must configure the Network Utility with an IP address and enable SNMP with a read-write community name. Each of the sample configurations in Part 2, Learning About Network Utility shows how to configure an IP address and SNMP for this communication, in both the Configuration Program and from talk 6.

If you want to use SNMP to download a Network Utility's very first configuration, see Procedure B: Configuration Program Initial Configuration.

If this is not the first configuration, make sure there is at least one unlocked configuration file position (other than the active one) in the currently active code bank on the hard disk. (See "Listing Configurations" for more information.)

After you have created a Network Utility configuration at the Configuration Program, use the following procedure to transfer that configuration to Network Utility using SNMP:

  1. Bring up the Configure drop-down menu and select Communications.

  2. From the pop-up, select Single router if you only want to send the current configuration to one Network Utility, or Multiple routers if you want to send any saved configuration to any number of target routers.

  3. From the next single-router panel, or multiple-router list panel, select the Send option and enter the necessary addressing information for the routers.

    You can also enter a date and time for the router to be restarted with this configuration, if you wish. There are two ways to do this:

    1. Select Send and Restart router 10

      The router stores the restart time in volatile memory, so if the Network Utility reboots before the scheduled time, the configuration is activated early.

      If you enter a date or time in the past, the router activates the new configuration immediately.

    2. Select Timed config

      The router stores the restart time in nonvolatile memory, so if the Network Utility reboots before the scheduled time it uses its current configuration. The newly downloaded configuration is not activated until the scheduled restart time arrives.

      If you enter a date or time in the past, the router stores the new configuration on disk but does not activate it. If a previous "timed config" restart operation is pending, it is cancelled.

    When you set the date and time by either of these methods it is not necessary to synchronize this date and time with the Network Utility, or even set a date and time at the Network Utility. The Configuration Program translates the date and time you set to a time interval and sends that value to the Network Utility.

  4. Click on OK (or Run for the multiple-router list), and the Configuration Program starts sending configuration data items to the specified router or routers using SNMP. Sending starts immediately, regardless of whether you specified a later date and time for the target routers to reboot.

  5. The Configuration Program provides status and result messages about the transfer. If you have problems and are sending to a single router, you may want to try the Query router information button instead of Send. This option retrieves a short amount of information from the router. You can use it to see whether you have an SNMP communication path to the router.

When a router begins to receive a configuration through SNMP, that configuration replaces any talk 6 changes made since the last reboot. When the transfer is complete, the Network Utility writes the received configuration to disk and activates it based on what you selected when you initiated the send operation.

Using the Operational Code

You can use the operational code to pull in a configuration file that was created in one of two ways:

As Table 7-1 shows, the configuration transfer procedures you can initiate from the op-code all use TFTP as the file transfer protocol.

Using TFTP

The op-code procedure for using TFTP to transfer a configuration file to the Network Utility hard disk is:

  1. Place the configuration file on a workstation that has TFTP server software installed and IP network physical connectivity to the Network Utility.

  2. Access the firmware main menu using the procedure described in Boot Options: Fast Boot and Reaching Firmware.

  3. Configure the IP addresses you will be using.

    If you are using a standard network interface including an Ethernet or Token-Ring adapter, use the Configuration Program or talk 6 to configure an IP address for the interface in the normal way. (From talk 6, use add address in the IP subprocess.) Activate this configuration change before proceeding.

    If you are using the PCMCIA EtherJet card, use system set ip to set the following addresses:

    If you are using SLIP, you cannot change the IP addresses but must use those given in Table 7-1.

  4. Transfer the files

    From the * prompt, follow this sequence:

      *t 6
      Config>boot
      Boot configuration
      Boot config>tftp get config
    

    Respond to the prompts as follows:

    Based on the server IP address and the configured Network Utility interface IP addresses, the Network Utility selects which of its interfaces to use to reach the server. The Network Utility gives success or failure status messages as appropriate.

  5. Reboot or schedule a reboot to use the configuration.

    To activate the new configuration immediately, use the following procedure from the Boot Config> prompt:

    1. Use the set command to select the new configuration so that it will be used for the next reboot.
    2. Press Ctrl-p and then enter reload to reboot the Network Utility

    To activate the new configuration later, type timedload activate from the Boot config> prompt to select the bank and new configuration, and to specify the date and time for the Network Utility to reboot. You can answer "no" to the questions about loading, because you already did this step.

See the MAS Software User's Guide chapter "Configuring Change Management" for more information on the commands in the above procedure.

Using the Firmware

You can use the firmware to pull in a configuration file that was created in one of two ways:

As Table 7-1 shows, the firmware supports both XMODEM and TFTP file transfer protocols.

Using Xmodem

The firmware procedure for using Xmodem to transfer a configuration file to the Network Utility hard disk is:

  1. Place the configuration file on the workstation with the terminal emulation software supporting your current user console session.

  2. Access the firmware main menu using the procedures described in Boot Options: Fast Boot and Reaching Firmware.

  3. Make the following sequence of menu selections:
    1. System Management Services (main menu): Option 4, "Utilities"
    2. System Management Utilities: Option 12, "Change Management"
    3. Change Management Software Control: Option 12, "Xmodem software"
    4. Select Type: "Config"
    5. Select Bank: choose Bank A or Bank B
    6. Select Config: choose an unlocked position

    The firmware tells you when to start the file transfer.

  4. Go to your terminal emulation package and start the transfer of the file from your workstation server, using whatever name you like. When the transfer starts, the status of the file position changes to CORRUPT, to indicate that it does not contain a complete configuration file. When the transfer completes, the status of the file position changes to AVAIL. You can verify that this has happened using option 7, "List Software" from the firmware Change Management menu.

  5. Boot the Network Utility using the configuration you just loaded.

    Use Option 9 "Set Boot Information" to select the current op-code bank and the new configuration. Press Esc to reach the main menu, and then F9 to boot the Network Utility with the new configuration.

Using TFTP

The firmware procedure for using TFTP to transfer a configuration file to a Network Utility hard disk is:

  1. Place the configuration file on a workstation that has TFTP server software installed and IP network physical connectivity to the Network Utility.

  2. Access the firmware main menu using the procedures described in Boot Options: Fast Boot and Reaching Firmware.

  3. Configure the IP addresses you will be using:

    Follow the menu sequence:

    1. System Management Services (main menu): Option 4, "Utilities"
    2. System Management Utilities: Option 11, "Remote Initial Program Load Setup"
    3. Network Parameters: Option 1, "IP Parameters"

    Set the following addresses:

  4. Initiate the transfer through these menu selections:
    1. System Management Services (main menu): Option 4, "Utilities"
    2. System Management Utilities: Option 12, "Change Management"
    3. Change Management Software Control: Option 10, "TFTP software"
    4. Select Type: "Config"
    5. Select Bank: choose Bank A or Bank B

  5. Enter the path and filename of the configuration file on your workstation

  6. If prompted, select the interface through which you want the firmware to do the file transfer.

    The firmware transfers the configuration file and gives status messages. On completion, you will be back at the Change Management menu.

  7. Boot the Network Utility using the configuration you just loaded

    Use Option 9 "Set Boot Information" to select the current op-code bank and the new configuration. Press Esc to reach the main menu, and then F9 to boot the Network Utility with the new configuration.


Transferring Configuration Files from Network Utility

You may want to transfer a configuration file from a Network Utility for any of the following reasons:

For the operational code procedures to transfer a configuration to a Network Utility, there is a reverse procedure for transferring a configuration from a Network Utility. The steps are virtually identical, so the following procedure lists only the essential differences.

  1. Import a .CFG file into the Configuration Program.

    Transfer the .CFG file to the Configuration Program workstation. Do a Read router configuration instead of a Create router configuration.

  2. Use SNMP to transfer a configuration into the Configuration Program. Do a Retrieve configuration instead of a Send configuration.

  3. Use operational code TFTP to send a configuration from the Network Utility. Type tftp put config instead of tftp get config.

There are no firmware-based procedures to transfer a configuration from a Network Utility.


Footnotes:

10
You can also do a Send, followed by a manual Restart router operation at a later time.


[ Top of Page | Previous Page | Next Page | Table of Contents ]